Funzione CryptSetKeyIdentifierProperty (wincrypt.h)

Articolo
08/27/2023

Importante Questa API è deprecata. Il software nuovo e esistente deve iniziare a usare le API di nuova generazione di crittografia. Microsoft può rimuovere questa API nelle versioni future.

La funzione CryptSetKeyIdentifierProperty imposta la proprietà di un identificatore di chiave specificato. Questa funzione può impostare la proprietà nel computer identificato in pwszComputerName.

Sintassi

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

Parametri

[in] pKeyIdentifier

Puntatore a un CRYPT_HASH_BLOB contenente l'identificatore della chiave.

[in] dwPropId

Identifica la proprietà da impostare. Il valore dwPropId determina il tipo e il contenuto del parametro pvData . È possibile usare qualsiasi ID proprietà del certificato. CERT_KEY_PROV_INFO_PROP_ID è la proprietà della maggior parte degli interessi.

[in] dwFlags

È possibile impostare i flag seguenti. Possono essere combinati con un'operazione bit per bit-OR .

Valore	Significato
CRYPT_KEYID_MACHINE_FLAG	Imposta la proprietà di LocalMachine (se pwszComputerName è NULL) o il computer remoto (se pwszComputerName non è NULL). Per altre informazioni, vedere pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	L'identificatore della chiave e tutte le relative proprietà vengono eliminate.
CRYPT_KEYID_SET_NEW_FLAG	Imposta una nuova proprietà identificatore di chiave. Se la proprietà esiste già, il tentativo ha esito negativo e FALSE viene restituito con l'ultimo codice di errore impostato su CRYPT_E_EXISTS.

[in] pwszComputerName

Puntatore a una stringa con terminazione null contenente il nome di un computer remoto con identificatore di chiave in cui vengono impostate le proprietà. Se CRYPT_KEYID_MACHINE_FLAG flag è impostato, cerca nel computer remoto un elenco di identificatori di chiave. Se il computer locale deve essere impostato e non un computer remoto, impostare pwszComputerName su NULL.

[in] pvReserved

Riservato per l'uso futuro e deve essere NULL.

[out] pvData

Se dwPropId è CERT_KEY_PROV_INFO_PROP_ID, pvData punta a una struttura CRYPT_KEY_PROV_INFO contenente la proprietà dell'identificatore della chiave.

Se dwPropId non è CERT_KEY_PROV_INFO_PROP_ID, pvData punta a una struttura CRYPT_DATA_BLOB contenente la proprietà dell'identificatore della chiave.

L'impostazione di pvData su NULL elimina la proprietà.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE). Per informazioni sull'errore estese, chiamare GetLastError.

Nota Se CRYPT_KEYID_SET_NEW_FLAG è impostato e la proprietà esiste già, FALSE viene restituito con l'ultimo codice di errore impostato su CRYPT_E_EXISTS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

Funzioni identificatore chiave

Condividi tramite