GetComputerObjectNameA-Funktion (secext.h)
Ruft den Namen des lokalen Computers in einem angegebenen Format ab.
Syntax
BOOLEAN SEC_ENTRY GetComputerObjectNameA(
[in] EXTENDED_NAME_FORMAT NameFormat,
[out] LPSTR lpNameBuffer,
[in, out] PULONG nSize
);
Parameter
[in] NameFormat
Das Format für den Namen. Dieser Parameter ist ein Wert aus dem EXTENDED_NAME_FORMAT Enumerationstyp. Es kann nicht NameUnknown sein.
[out] lpNameBuffer
Ein Zeiger auf einen Puffer, der den Namen im angegebenen Format empfängt.
Wenn dieser Parameter NULL-ist, wird entweder die Funktion erfolgreich ausgeführt, und der lpnSize Parameter empfängt die erforderliche Größe, oder die Funktion schlägt mit ERROR_INSUFFICIENT_BUFFER fehl, und lpnSize erhält die erforderliche Größe. Das Verhalten hängt vom Wert NameFormat- und der Version des Betriebssystems ab.
[in, out] nSize
Gibt bei eingaben die Größe des lpNameBuffer- Puffers in TCHARs-an. Bei Erfolg erhält die Größe des in den Puffer kopierten Namens. Wenn der lpNameBuffer- Puffer zu klein ist, um den Namen zu speichern, schlägt die Funktion fehl, und lpnSize erhält die erforderliche Puffergröße.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Anmerkung
Der secext.h-Header definiert GetComputerObjectName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | secext.h (include Security.h) |
| Library | Secur32.lib |
| DLL- | Secur32.dll |
| API-Satz | ext-ms-win-secur32-translatename-l1-1-0 (eingeführt in Windows 8) |