Função CertGetValidUsages (wincrypt.h)

A função CertGetValidUsages retorna uma matriz de usos que consistem na interseção dos usos válidos para todos os certificados em uma matriz de certificados.

Sintaxe

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

Parâmetros

[in] cCerts

O número de certificados na matriz a ser verificada.

[in] rghCerts

Uma matriz de certificados a ser verificada quanto ao uso válido.

[out] cNumOIDs

O número de usos válidos encontrados como a interseção dos usos válidos de todos os certificados na matriz. Se todos os certificados forem válidos para todos os usos, cNumOIDs será definido como negativo (–1).

[out] rghOIDs

Uma matriz dos identificadores de objeto (OIDs) dos usos válidos que são compartilhados por todos os certificados na matriz rghCerts . Esse parâmetro pode ser NULL para definir o tamanho dessa estrutura para fins de alocação de memória. Para obter mais informações, consulte Recuperando dados de comprimento desconhecido.

[in, out] pcbOIDs

Um ponteiro para um valor DWORD que especifica o tamanho, em bytes, da matriz rghOIDs e as cadeias de caracteres apontadas. Quando a função retorna, o valor DWORD contém o número de bytes necessários para a matriz.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos