Función CryptSetKeyIdentifierProperty (wincrypt.h)

Artículo
08/27/2023

Importante Esta API está en desuso. El software nuevo y existente debe empezar a usar las API cryptography Next Generation. Microsoft puede quitar esta API en futuras versiones.

La función CryptSetKeyIdentifierProperty establece la propiedad de un identificador de clave especificado. Esta función puede establecer la propiedad en el equipo identificado en pwszComputerName.

Sintaxis

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

Parámetros

[in] pKeyIdentifier

Puntero a un CRYPT_HASH_BLOB que contiene el identificador de clave.

[in] dwPropId

Identifica la propiedad que se va a establecer. El valor de dwPropId determina el tipo y el contenido del parámetro pvData . Se puede usar cualquier identificador de propiedad de certificado. CERT_KEY_PROV_INFO_PROP_ID es la propiedad de mayor interés.

[in] dwFlags

Se pueden establecer las marcas siguientes. Se pueden combinar con una operación OR bit a bit.

Valor	Significado
CRYPT_KEYID_MACHINE_FLAG	Establece la propiedad de LocalMachine (si pwszComputerName es NULL) o equipo remoto (si pwszComputerName no es NULL). Para obtener más información, vea pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	Se eliminan el identificador de clave y todas sus propiedades.
CRYPT_KEYID_SET_NEW_FLAG	Establece una nueva propiedad de identificador de clave. Si la propiedad ya existe, se produce un error en el intento y se devuelve FALSE con el último código de error establecido en CRYPT_E_EXISTS.

[in] pwszComputerName

Puntero a una cadena terminada en null que contiene el nombre de un equipo remoto que tiene el identificador de clave donde se establecen las propiedades. Si se establece CRYPT_KEYID_MACHINE_FLAG marca, busca en el equipo remoto una lista de identificadores de clave. Si el equipo local se va a establecer y no un equipo remoto, establezca pwszComputerName en NULL.

[in] pvReserved

Reservado para uso futuro y debe ser NULL.

[out] pvData

Si dwPropId es CERT_KEY_PROV_INFO_PROP_ID, pvData apunta a una estructura de CRYPT_KEY_PROV_INFO que contiene la propiedad del identificador de clave.

Si dwPropId no es CERT_KEY_PROV_INFO_PROP_ID, pvData apunta a una estructura de CRYPT_DATA_BLOB que contiene la propiedad del identificador de clave.

Al establecer pvData en NULL , se elimina la propiedad .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE). Para obtener información de error extendida, llame a GetLastError.

Nota Si se establece CRYPT_KEYID_SET_NEW_FLAG y la propiedad ya existe, se devuelve FALSE con el último código de error establecido en CRYPT_E_EXISTS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

Funciones de identificador de clave