Funzione GetComputerObjectNameA (secext.h)
Recupera il nome del computer locale in un formato specificato.
Sintassi
BOOLEAN SEC_ENTRY GetComputerObjectNameA(
[in] EXTENDED_NAME_FORMAT NameFormat,
[out] LPSTR lpNameBuffer,
[in, out] PULONG nSize
);
Parametri
[in] NameFormat
Formato del nome. Questo parametro è un valore del tipo di enumerazione EXTENDED_NAME_FORMAT. Non può essere NameUnknown.
[out] lpNameBuffer
Puntatore a un buffer che riceve il nome nel formato specificato.
Se questo parametro è NULL, la funzione ha esito positivo e il parametro lpnSize riceve le dimensioni necessarie oppure la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER e lpnSize riceve le dimensioni necessarie. Il comportamento dipende dal valore di NameFormat e dalla versione del sistema operativo.
[in, out] nSize
In input, specifica le dimensioni del buffer lpNameBuffer
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Nota
L'intestazione secext.h definisce GetComputerObjectName 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 |
secext.h (include Security.h) |
| libreria |
Secur32.lib |
| dll | Secur32.dll |
| set di API | ext-ms-win-secur32-translatename-l1-1-0 (introdotto in Windows 8) |