Funzione RpcCertGeneratePrincipalName (rpcssl.h)

I programmi server usano la funzione RpcCertGeneratePrincipalName per generare nomi di entità per i certificati di sicurezza.

Sintassi

RPC_STATUS RpcCertGeneratePrincipalName(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_CSTR       *pBuffer
);

Parametri

Context

Puntatore al contesto del certificato di sicurezza.

Flags

Attualmente, l'unico flag valido per questo parametro è RPC_C_FULL_CERT_CHAIN. L'uso di questo flag fa sì che il nome dell'entità venga generato in formato fullsic.

pBuffer

Puntatore a un puntatore. La funzione RpcCertGeneratePrincipalName imposta questo valore in modo che punti a una stringa con terminazione Null contenente il nome dell'entità.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

Per impostazione predefinita, il nome dell'entità restituito dalla funzione RpcCertGeneratePrincipalName è in formato msstd. Per generare un nome in formato fullsic, passare RPC_C_FULL_CERT_CHAIN come valore per il parametro Flags .

L'applicazione deve chiamare RpcStringFree per rilasciare la memoria per la stringa che contiene il nome dell'entità.

Requisiti

Vedi anche

Nomi delle entità

RpcStringFree