Funzione CertGetValidUsages (wincrypt.h)

La funzione CertGetValidUsages restituisce una matrice di utilizzi costituita dall'intersezione degli utilizzi validi per tutti i certificati in una matrice di certificati.

Sintassi

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

Parametri

[in] cCerts

Numero di certificati nella matrice da controllare.

[in] rghCerts

Matrice di certificati da verificare per l'utilizzo valido.

[out] cNumOIDs

Numero di utilizzi validi rilevati come intersezione degli utilizzi validi di tutti i certificati nella matrice. Se tutti i certificati sono validi per tutti gli utilizzi, cNumOID è impostato su uno negativo (–1).

[out] rghOIDs

Matrice degli identificatori di oggetto (OID) degli utilizzi validi condivisi da tutti i certificati nella matrice rghCerts . Questo parametro può essere NULL per impostare le dimensioni di questa struttura ai fini dell'allocazione della memoria. Per altre informazioni, vedere Recupero di dati di lunghezza sconosciuta.

[in, out] pcbOIDs

Puntatore a un valore DWORD che specifica le dimensioni, in byte, della matrice rghOIDs e le stringhe a cui punta. Al termine della funzione, il valore DWORD contiene il numero di byte necessari per la matrice.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero. Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni sugli errori estesi, chiamare GetLastError.

Requisiti

Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll