Freigeben über


RKeyPFXInstall-Funktion

Die RKeyPFXInstall-Funktion wird nicht unterstützt.

Windows Server 2003: Die RKeyPFXInstall-Funktion installiert ein Zertifikat auf einem Remotecomputer. Beachten Sie, dass sich dieses Verhalten mit Windows Server 2003 mit Service Pack 1 (SP1) geändert hat.

Syntax

ULONG RKeyPFXInstall(
  _In_ KEYSVCC_HANDLE         hKeySvcCli,
  _In_ PKEYSVC_BLOB           pPFX,
  _In_ PKEYSVC_UNICODE_STRING pPassword,
  _In_ ULONG                  ulFlags
);

Parameter

hKeySvcCli [in]

Ein KEYSVCC_HANDLE-Handle , das zuvor von RKeyOpenKeyService geöffnet wurde. Das Handle stellt den Remotecomputer dar, der das Zertifikat erhält. Dieser Wert darf nicht NULL sein.

pPFX [in]

Ein Zeiger auf eine KEYSVC_BLOB-Struktur , die das zu installierende Zertifikat darstellt. Das BLOB hat das PKCS #12-Format .

pPassword [in]

Ein Zeiger auf eine KEYSVC_UNICODE_STRING-Struktur , die das Kennwort für das BLOB darstellt. Wenn Sie das Kennwort verwendet haben, löschen Sie das Kennwort aus dem Arbeitsspeicher, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schutz von Kennwörtern finden Sie unter Behandeln von Kennwörtern.

ulFlags [in]

Flags, die die Zertifikatinstallationsoptionen angeben. Dieser Parameter kann eine Null oder eine Kombination der folgenden Werte sein.

Wert Bedeutung
CRYPT_EXPORTABLE
Importierte Schlüssel werden als exportierbar markiert.
CRYPT_MACHINE_KEYSET
Private Schlüssel werden unter dem Remotecomputer und nicht unter dem aktuellen Benutzer gespeichert.

 

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein ULONG , der 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

Weitere Informationen

RKeyCloseKeyService

RKeyOpenKeyService