Compartir a través de

Función CertGetValidUsages (wincrypt.h)

  • Artículo

La función CertGetValidUsages devuelve una matriz de usos que consta de la intersección de los usos válidos para todos los certificados de una matriz de certificados.

Sintaxis

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

Parámetros

[in] cCerts

Número de certificados de la matriz que se va a comprobar.

[in] rghCerts

Matriz de certificados que se van a comprobar para el uso válido.

[out] cNumOIDs

Número de usos válidos encontrados como la intersección de los usos válidos de todos los certificados de la matriz. Si todos los certificados son válidos para todos los usos, cNumOIDs se establece en negativo (–1).

[out] rghOIDs

Matriz de los identificadores de objeto (OID) de los usos válidos que comparten todos los certificados de la matriz rghCerts . Este parámetro puede ser NULL para establecer el tamaño de esta estructura con fines de asignación de memoria. Para obtener más información, vea Recuperar datos de longitud desconocida.

[in, out] pcbOIDs

Puntero a un valor DWORD que especifica el tamaño, en bytes, de la matriz rghOIDs y de las cadenas a las que apunta. Cuando la función devuelve, el valor DWORD contiene el número de bytes necesarios para la matriz.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero. Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

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