Función WintrustGetDefaultForUsage (wintrust.h)

  • Artículo

La función WintrustGetDefaultForUsage recupera el identificador de uso predeterminado y la información de devolución de llamada.

Sintaxis

BOOL WintrustGetDefaultForUsage(
  [in]      DWORD                   dwAction,
  [in]      const char              *pszUsageOID,
  [in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);

Parámetros

[in] dwAction

Acción que se va a realizar. Puede ser uno de los valores siguientes. Para obtener más información, vea la sección Comentarios.

Valor Significado
DWACTION_ALLOCANDFILL
 Asigne memoria y rellene la estructura de CRYPT_PROVIDER_DEFUSAGE a la que apunta el parámetro psUsage .
DWACTION_FREE
 Libere toda la memoria asignada durante una llamada anterior a esta función especificando DWACTION_ALLOCANDFILL para este parámetro.

[in] pszUsageOID

Puntero a una cadena que contiene el identificador.

[in, out] psUsage

Puntero a una estructura de CRYPT_PROVIDER_DEFUSAGE que contiene información de devolución de llamada que se va a recuperar.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; FALSE si se produce un error en la función. Si se produce un error en la función , llame a la función GetLastError para determinar el motivo del error.

Comentarios

Llame a esta función una vez con el parámetro dwAction establecido en DWACTION_ALLOCANDFILL para asignar memoria y rellenar una estructura de CRYPT_PROVIDER_DEFUSAGE con información. Vuelva a llamar a esta función con el parámetro dwAction establecido en DWACTION_FREE para liberar la memoria asignada.

La información de uso y devolución de llamada predeterminadas de un proveedor se registra mediante una llamada a la función WintrustAddDefaultForUsage .

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 wintrust.h
Library Wintrust.lib
Archivo DLL Wintrust.dll

Consulte también

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage