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
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcssl.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |