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 per il 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 nameFormat e dalla versione del sistema operativo.
[in, out] nSize
In input specifica le dimensioni del buffer lpNameBuffer , in TCHAR. In caso di esito positivo, riceve le dimensioni del nome copiato nel buffer. Se il buffer lpNameBuffer è troppo piccolo per contenere il nome, la funzione ha esito negativo e lpnSize riceve le dimensioni del buffer necessarie.
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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| 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) |