Función WintrustAddActionID (wintrust.h)

  • Artículo

[La función WintrustAddActionID está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Para la comprobación de certificados, use las funciones CertGetCertificateChain y CertVerifyCertificateChainPolicy . Para la comprobación de la firma de la tecnología Microsoft Authenticode , use .NET Framework.]

La función WintrustAddActionID agrega una acción de proveedor de confianza al sistema del usuario. Se debe llamar a este método durante la implementación dllRegisterServer del proveedor de confianza. Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Wintrust.dll.

Solo un proveedor de confianza debe llamar a este método.

Sintaxis

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Parámetros

[in] pgActionID

Puntero a una estructura GUID que identifica la acción que se va a agregar y el proveedor de confianza que admite esa acción.

El servicio WinTrust está diseñado para trabajar con proveedores de confianza implementados por terceros. Cada proveedor de confianza proporciona su propio conjunto único de identificadores de acción. Para obtener información sobre los identificadores de acción admitidos por un proveedor de confianza, consulte la documentación de ese proveedor de confianza.

Por ejemplo, Microsoft proporciona un proveedor de confianza del publicador de software que puede establecer la confiabilidad del software que se descarga de Internet o de alguna otra red pública. El proveedor de confianza del publicador de software admite los siguientes identificadores de acción. Estas constantes se definen en Softpub.h.

Valor Significado
WINTRUST_ACTION_GENERIC_VERIFY
 Compruebe solo una cadena de certificados.
WINTRUST_ACTION_GENERIC_VERIFY_V2
 Compruebe un archivo o un objeto mediante el proveedor de directivas Authenticode.
HTTPSPROV_ACTION
 Compruebe una conexión SSL/PCT a través de Internet Explorer.

[in] fdwFlags

valor que determina si esta función notifica errores del Registro. Si fdwFlags es cero y esta función experimenta un error del Registro, el error del Registro no se propagará a la función GetLastError . Si fdwFlags es WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) y esta función experimenta un error del Registro, el error del Registro se propagará a la función GetLastError .

[in] psProvInfo

Puntero a la estructura CRYPT_REGISTER_ACTIONID que define la información del proveedor de confianza.

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. Para obtener información sobre los errores del Registro que puede encontrar esta función, consulte la descripción de fdwFlags.

Comentarios

Para quitar una acción agregada por esta función, llame a la función WintrustRemoveActionID .

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

WintrustRemoveActionID