CryptSetKeyIdentifierProperty-Funktion (wincrypt.h)

Artikel
03/03/2024

Wichtig Diese API ist veraltet. Neue und vorhandene Software sollten mit der Verwendung von Kryptografie-APIs der nächsten Generation beginnen. Microsoft kann diese API in zukünftigen Releases entfernen.

Die CryptSetKeyIdentifierProperty-Funktion legt die Eigenschaft eines angegebenen Schlüsselbezeichners fest. Diese Funktion kann die -Eigenschaft auf dem in pwszComputerName identifizierten Computer festlegen.

Syntax

BOOL CryptSetKeyIdentifierProperty(
  [in]  const CRYPT_HASH_BLOB *pKeyIdentifier,
  [in]  DWORD                 dwPropId,
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pwszComputerName,
  [in]  void                  *pvReserved,
  [out] const void            *pvData
);

Parameter

[in] pKeyIdentifier

Ein Zeiger auf eine CRYPT_HASH_BLOB , die den Schlüsselbezeichner enthält.

[in] dwPropId

Gibt die festzulegende Eigenschaft an. Der Wert von dwPropId bestimmt den Typ und den Inhalt des pvData-Parameters . Es kann eine beliebige Zertifikateigenschaften-ID verwendet werden. CERT_KEY_PROV_INFO_PROP_ID ist die Eigenschaft von größtem Interesse.

[in] dwFlags

Die folgenden Flags können festgelegt werden. Sie können mit einem bitweisen OR-Vorgang kombiniert werden.

Wert	Bedeutung
CRYPT_KEYID_MACHINE_FLAG	Legt die Eigenschaft von LocalMachine (wenn pwszComputerNameNULL ist) oder des Remotecomputers (wenn pwszComputerName nicht NULL ist) fest. Weitere Informationen finden Sie unter pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	Der Schlüsselbezeichner und alle zugehörigen Eigenschaften werden gelöscht.
CRYPT_KEYID_SET_NEW_FLAG	Legt eine neue Schlüsselbezeichnereigenschaft fest. Wenn die Eigenschaft bereits vorhanden ist, schlägt der Versuch fehl, und FALSE wird zurückgegeben, wobei der letzte Fehlercode auf CRYPT_E_EXISTS festgelegt ist.

[in] pwszComputerName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen eines Remotecomputers enthält, der den Schlüsselbezeichner enthält, in dem die Eigenschaften festgelegt werden. Wenn CRYPT_KEYID_MACHINE_FLAG-Flag festgelegt ist, durchsucht den Remotecomputer nach einer Liste mit Schlüsselbezeichnern. Wenn der lokale Computer und kein Remotecomputer festgelegt werden soll, legen Sie pwszComputerName auf NULL fest.

[in] pvReserved

Für die zukünftige Verwendung reserviert und muss NULL sein.

[out] pvData

Wenn dwPropId CERT_KEY_PROV_INFO_PROP_ID ist, verweist pvData auf eine CRYPT_KEY_PROV_INFO-Struktur , die die Eigenschaft des Schlüsselbezeichners enthält.

Wenn dwPropId nicht CERT_KEY_PROV_INFO_PROP_ID ist, verweist pvData auf eine CRYPT_DATA_BLOB Struktur, die die Eigenschaft des Schlüsselbezeichners enthält.

Durch Festlegen von pvData auf NULL wird die Eigenschaft gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE). Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweis Wenn CRYPT_KEYID_SET_NEW_FLAG festgelegt ist und die Eigenschaft bereits vorhanden ist, wird FALSE zurückgegeben, wobei der letzte Fehlercode auf CRYPT_E_EXISTS festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

Schlüsselbezeichnerfunktionen

Freigeben über