SLPOpen-Subroutine

Zweck

Gibt eine SLPHandle -Kennung zurück, die die Spracheinstellung für SLP-Anforderungen kapselt.

Syntax

SLPError SLPOpen(const char *pcLang, SLPBoolean isAsync, SLPHandle
   *phSLP);

Beschreibung

Die Subroutine SLPOpen gibt eine Kennung SLPHandle im Parameter phSLP für die Sprachländereinstellung zurück, die als Parameter pcLang übergeben wurde. Der Client gibt über den Parameter isAsync an, ob Operationen für die Kennung synchron oder asynchron sein sollen. Die Kennung kapselt die Spracheinstellung für SLP-Anforderungen, die über die Kennung ausgegeben werden, sowie alle anderen Ressourcen, die für die Implementierung erforderlich sind. SLP-Eigenschaften werden jedoch nicht durch die Kennung gekapselt, sondern sind global. Der Rückgabewert der Funktion ist ein SLPError -Code, der den Status der Operation angibt. Bei einem Fehler ist der phSLP -Parameter NULL.

Implementierungsspezifikationen

Ein SLPHandle kann nur für jeweils eine SLP-API-Operation verwendet werden. Wenn die ursprüngliche Operation asynchron gestartet wurde, führt jeder Versuch, eine zusätzliche Operation für die Kennung zu starten, während die ursprüngliche Operation ansteht, zur Rückgabe eines Fehlers SLP_HANDLE_IN_USE von der API-Funktion. Die API-Funktion SLPClose () beendet alle ausstehenden Aufrufe für die Kennung. Wenn eine Implementierung nicht in der Lage ist, eine asynchrone (bzw. Synchrone Operation), aufgrund von Speichereinschränkungen oder fehlender Threading-Unterstützung, kann das Flag SLP_NOT_IMPLEMENTIERT zurückgegeben werden, wenn das Flag isAsync auf SLP_TRUE (bzw. SLP_FALSE ).

Parameter

Rückgabewerte

Wenn SLPOpen erfolgreich ist, wird SLP_OK und eine Kennung SLPHandle im Parameter phSLP für die Ländereinstellung zurückgegeben, die als Parameter pcLang übergeben wird.

Fehlercodes