Método ICEnroll::acceptFilePKCS7 (xenroll.h)

Artigo
03/13/2024

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método acceptFilePKCS7 aceita e processa um arquivo que contém uma mensagem PKCS nº 7 que contém um certificado. Esse método foi definido pela primeira vez na interface ICEnroll .

Sintaxe

HRESULT acceptFilePKCS7(
  [in] BSTR wszPKCS7FileName
);

Parâmetros

[in] wszPKCS7FileName

Especifica o nome do arquivo que contém a mensagem PKCS nº 7.

Retornar valor

VB

O valor retornado é um HRESULT. Um valor de S_OK indica êxito. Após a conclusão bem-sucedida dessa função, a mensagem PKCS nº 7 no arquivo será aceita.

Comentários

Por padrão, os repositórios do sistema My, Ca, Root e Request são usados para armazenar os certificados. No entanto, você pode especificar outros repositórios atribuindo as seguintes propriedades antes de chamar esse método:

O método acceptFilePKCS7 difere de acceptPKCS7 somente no caso de um arquivo fornecer o certificado.

Exemplos

HRESULT  hr;
BSTR     bstrFileName;

// Allocate a BSTR referencing an existing file, 
// for example, "myPKCS7.fil".
bstrFileName = SysAllocString(TEXT("<FILENAMEHERE>"));
if (NULL == bstrFileName)
{
    //handle error
}

// pEnroll is a previously instantiated ICEnroll interface pointer.
hr = pEnroll->acceptFilePKCS7( bstrFileName );
if (FAILED(hr))
    printf("Failed acceptFilePKCS7 - %x\n", hr );
else
	printf("Accepted PKCS #7 from file %ws successfully\n", 
	bstrFileName );

// Free BSTR when done.
if (bstrFileName)
    SysFreeString(bstrFileName);

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	xenroll.h
Biblioteca	Uuid.lib
DLL	Xenroll.dll