RKeyOpenKeyService-Funktion

Artikel
06/13/2023

Die RKeyOpenKeyService-Funktion wird nicht unterstützt.

Windows Server 2003: Die RKeyOpenKeyService-Funktion stellt eine Verbindung mit einem Remotecomputer her und öffnet ein Schlüsseldiensthandle. Das Schlüsseldiensthandle kann anschließend von der RKeyPFXInstall-Funktion verwendet werden. Beachten Sie, dass sich dieses Verhalten mit Windows Server 2003 mit Service Pack 1 (SP1) geändert hat.

Syntax

ULONG RKeyOpenKeyService(
  _In_    LPSTR          pszMachineName,
  _In_    KEYSVC_TYPE    OwnerType,
  _In_    LPWSTR         pwszOwnerName,
  _In_    void           *pAuthentication,
  _Inout_ void           *pReserved,
  _Out_   KEYSVCC_HANDLE *phKeySvcCli
);

Parameter

pszMachineName [in]

Langer Zeiger auf eine NULL-endende Zeichenfolge, die den Computer darstellt, auf dem das Schlüsseldiensthandle geöffnet wird.

OwnerType [in]

KEYSVC_TYPE Wert, der den Schlüsseltyp darstellt. Der einzige unterstützte Wert ist KeySvcMachine.

pwszOwnerName [in]

Reserviert. Legen Sie diesen Wert auf NULL fest.

pAuthentication [in]

Ein Zeiger auf eine void , die die Authentifizierungseinstellungen darstellt. Dieser Zeiger kann auf einen Wert von 0 oder den folgenden Wert verweisen.

Wert	Bedeutung
RKEYSVC_CONNECT_SECURE_ONLY	Der Client erfordert eine gegenseitige Authentifizierung. Wenn dieser Wert angegeben wird, schlägt das Fallback auf NTLM fehl.

pReserved [in, out]

Reserviert. Legen Sie diesen Wert auf NULL fest.

phKeySvcCli [out]

Ein Zeiger auf einen KEYSVCC_HANDLE , der das geöffnete Schlüsseldiensthandle empfängt. Wenn Sie die Verwendung des Handles abgeschlossen haben, geben Sie die Ressource frei, indem Sie die Funktion RKeyCloseKeyService aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert eine ULONG , die den Fehler angibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Rkeysvcc.h

Siehe auch

RKeyCloseKeyService
RKeyPFXInstall

Share via