Função CertModifyCertificatesToTrust (cryptdlg.h)

Artigo
03/05/2024

A função CertModifyCertificatesToTrust modifica o conjunto de certificados em uma CTL (lista de certificados confiáveis) para uma determinada finalidade.

Nota Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a CryptDlg.dll.

Sintaxe

CRYPTDLGAPI HRESULT CertModifyCertificatesToTrust(
  [in]           int                 cCerts,
  [in]           PCTL_MODIFY_REQUEST rgCerts,
  [in]           LPCSTR              szPurpose,
  [in]           HWND                hwnd,
  [in, optional] HCERTSTORE          hcertstoreTrust,
  [in, optional] PCCERT_CONTEXT      pccertSigner
);

Parâmetros

[in] cCerts

O número de solicitações de modificação que estão no parâmetro rgCerts .

[in] rgCerts

Um ponteiro para uma estrutura CTL_MODIFY_REQUEST que contém uma matriz de solicitações de modificação.

[in] szPurpose

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a representação de cadeia de caracteres de um OID (identificador de objeto). O OID especifica o EKU (uso aprimorado de chave) da CTL a ser modificada.

[in] hwnd

Um identificador para a janela pai das caixas de diálogo geradas por essa função.

[in, optional] hcertstoreTrust

Um identificador para o repositório de certificados no qual modificar a lista de certificados confiáveis. Se FOR NULL, o repositório de Pessoas Confiáveis será usado com o local do Usuário Atual.

[in, optional] pccertSigner

Um ponteiro para uma estrutura CERT_CONTEXT que contém um certificado. Ele é usado para assinar a lista de confiança. O certificado também restringe o conjunto de listas de confiança que podem ser modificadas. Se FOR NULL, a lista de confiança não será assinada.

Retornar valor

Um HRESULT. Um valor de S_OK indica êxito.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	cryptdlg.h
DLL	CryptDlg.dll

Confira também

CTL_MODIFY_REQUEST