Função RKeyPFXInstall

Artigo
06/13/2023

Não há suporte para a função RKeyPFXInstall .

Windows Server 2003: A função RKeyPFXInstall instala um certificado em um computador remoto. Observe que esse comportamento foi alterado com o Windows Server 2003 com o Service Pack 1 (SP1).

Sintaxe

ULONG RKeyPFXInstall(
  _In_ KEYSVCC_HANDLE         hKeySvcCli,
  _In_ PKEYSVC_BLOB           pPFX,
  _In_ PKEYSVC_UNICODE_STRING pPassword,
  _In_ ULONG                  ulFlags
);

Parâmetros

hKeySvcCli [in]

Um identificador de KEYSVCC_HANDLE aberto anteriormente por RKeyOpenKeyService. O identificador representa o computador remoto que receberá o certificado. Esse valor não pode ser NULL.

pPFX [in]

Um ponteiro para uma estrutura KEYSVC_BLOB que representa o certificado a ser instalado. O BLOB está no formato PKCS nº 12 .

pPassword [in]

Um ponteiro para uma estrutura KEYSVC_UNICODE_STRING que representa a senha do BLOB. Quando terminar de usar a senha, desmarque a senha da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger senhas, consulte Manipulando senhas.

ulFlags [in]

Sinalizadores que especificam as opções de instalação do certificado. Esse parâmetro pode ser um zero ou uma combinação dos valores a seguir.

Valor	Significado
CRYPT_EXPORTABLE	As chaves importadas são marcadas como exportáveis.
CRYPT_MACHINE_KEYSET	As chaves privadas são armazenadas no computador remoto e não no usuário atual.

Valor retornado

Se a função for bem-sucedida, o valor retornado será S_OK.

Se a função falhar, o valor retornado será um ULONG que indica o erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Rkeysvcc.h

Confira também

RKeyCloseKeyService
RKeyOpenKeyService

Compartilhar via