Función CertSelectionGetSerializedBlob (cryptuiapi.h)

La función CertSelectionGetSerializedBlob es una función auxiliar que se usa para recuperar un blob de certificado serializado de una estructura de CERT_SELECTUI_INPUT .

Sintaxis

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Parámetros

[in] pcsi

Puntero a una estructura de CERT_SELECTUI_INPUT que contiene el almacén de certificados y la información de la cadena de contexto del certificado.

[out] ppOutBuffer

Dirección de un puntero a un búfer que recibe los certificados serializados BLOB.

[out] pulOutBufferSize

Puntero a un ULONG para recibir el tamaño, en bytes, del BLOB recibido en el búfer al que apunta el parámetro ppOutBuffer .

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Si los parámetros hStore y prgpChain no son NULL, devuelva E_INVALIDARG. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El BLOB serializado devuelto se pasa a la función CredUIPromptForWindowsCredentials en el parámetro pvInAuthBuffer para permitir que un usuario seleccione un certificado mediante la interfaz de usuario de selección de credenciales.

Los certificados que se serializan en el BLOB devuelto en el búfer al que apunta el parámetro ppOutBuffer de esta función dependen de los valores de los miembros hStore y prgpChain de la estructura CERT_SELECTUI_INPUT .

Requisitos