Función CertGetValidUsages (wincrypt.h)
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 |