Export (0) Print
Expand All
Expand Minimize

CryptSetKeyIdentifierProperty function

The CryptSetKeyIdentifierProperty function sets the property of a specified key identifier. This function can set the property on the computer identified in pwszComputerName.

Syntax


BOOL WINAPI CryptSetKeyIdentifierProperty(
  _In_   const CRYPT_HASH_BLOB *pKeyIdentifier,
  _In_   DWORD dwPropId,
  _In_   DWORD dwFlags,
  _In_   LPCWSTR pwszComputerName,
  _In_   void *pvReserved,
  _Out_  const void *pvData
);

Parameters

pKeyIdentifier [in]

A pointer to a CRYPT_HASH_BLOB containing the key identifier.

dwPropId [in]

Identifies the property to be set. The value of dwPropId determines the type and content of the pvData parameter. Any certificate property ID can be used. CERT_KEY_PROV_INFO_PROP_ID is the property of most interest.

dwFlags [in]

The following flags can be set. They can be combined with a bitwise-OR operation.

ValueMeaning
CRYPT_KEYID_MACHINE_FLAG

Sets the property of the LocalMachine (if pwszComputerName is NULL) or remote computer (if pwszComputerName is not NULL). For more information, see pwszComputerName.

CRYPT_KEYID_DELETE_FLAG

The key identifier and all of its properties are deleted.

CRYPT_KEYID_SET_NEW_FLAG

Sets a new key identifier property. If the property already exists, the attempt fails, and FALSE is returned with the last error code set to CRYPT_E_EXISTS.

 

pwszComputerName [in]

A pointer to a null-terminated string that contains the name of a remote computer that has the key identifier where the properties are set. If CRYPT_KEYID_MACHINE_FLAG flag is set, searches the remote computer for a list of key identifiers. If the local computer is to be set and not a remote computer, set pwszComputerName to NULL.

pvReserved [in]

Reserved for future use and must be NULL.

pvData [out]

If dwPropId is CERT_KEY_PROV_INFO_PROP_ID, pvData points to a CRYPT_KEY_PROV_INFO structure containing the property of the key identifier.

If dwPropId is not CERT_KEY_PROV_INFO_PROP_ID, pvData points to a CRYPT_DATA_BLOB structure containing the property of the key identifier.

Setting pvData to NULL deletes the property.

Return value

If the function succeeds, the return value is nonzero (TRUE).

If the function fails, the return value is zero (FALSE). For extended error information, call GetLastError.

Note  If CRYPT_KEYID_SET_NEW_FLAG is set and the property already exists, FALSE is returned with the last error code set to CRYPT_E_EXISTS.

Examples

For an example that uses this function, see Example C Program: Working with Key Identifiers.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wincrypt.h

Library

Crypt32.lib

DLL

Crypt32.dll

See also

Key Identifier Functions
CryptEnumKeyIdentifierProperties
CryptGetKeyIdentifierProperty

 

 

Community Additions

ADD
Show:
© 2014 Microsoft