Funzione RKeyPFXInstall

La funzione RKeyPFXInstall non è supportata.

Windows Server 2003: La funzione RKeyPFXInstall installa un certificato in un computer remoto. Si noti che questo comportamento è stato modificato con Windows Server 2003 con Service Pack 1 (SP1).

Sintassi

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

Parametri

hKeySvcCli [in]

Handle KEYSVCC_HANDLE aperto in precedenza da RKeyOpenKeyService. L'handle rappresenta il computer remoto che riceverà il certificato. Questo valore non può essere NULL.

pPFX [in]

Puntatore a una struttura KEYSVC_BLOB che rappresenta il certificato da installare. Il BLOB è in formato PKCS #12 .

pPassword [in]

Puntatore a una struttura KEYSVC_UNICODE_STRING che rappresenta la password per il BLOB. Al termine dell'uso della password, cancellare la password dalla memoria chiamando la funzione SecureZeroMemory . Per altre informazioni sulla protezione delle password, vedere Gestione delle password.

ulFlags [in]

Flag che specificano le opzioni di installazione del certificato. Questo parametro può essere zero o una combinazione dei valori seguenti.

Valore Significato
CRYPT_EXPORTABLE
Le chiavi importate sono contrassegnate come esportabili.
CRYPT_MACHINE_KEYSET
Le chiavi private vengono archiviate nel computer remoto e non nell'utente corrente.

 

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene S_OK.

Se la funzione ha esito negativo, il valore restituito è un ULONG che indica l'errore.

Requisiti

Requisito Valore
Client minimo supportato
Nessuno supportato
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Rkeysvcc.h

Vedi anche

RKeyCloseKeyService

RKeyOpenKeyService