Funzione RpcCertGeneratePrincipalNameW (rpcssl.h)

Articolo
11/20/2024

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

Sintassi

RPC_STATUS RpcCertGeneratePrincipalNameW(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_WSTR       *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 determina la generazione del nome dell'entità in formato fullsic.

pBuffer

Puntatore a un puntatore. La funzione rpcCertGeneratePrincipalName imposta questa proprietà in modo che punti a una stringa con terminazione Null contenente il nome dell'entità di .

Valore restituito

Questa funzione non restituisce un valore.

Osservazioni

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à.

Nota

L'intestazione rpcssl.h definisce RpcCertGeneratePrincipalName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	rpcssl.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

nomi di entità

RpcStringFree

Condividi tramite