UtilLoadStringWithAlloc-Funktion

Die UtilLoadStringWithAlloc-Funktion ordnet eine Zeichenfolge zu und lädt sie aus der Ressourcentabelle.

Syntax

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

Parameter

uID [ In]

Typ: UINT

Bezeichner der zu ladenden Zeichenfolge.

ppwzBuffer [ out]

Typ: LPWSTR *

Der Speicherort, an dem die neu zugeordnete Zeichenfolge platziert wird. Die Zeichenfolge muss mit CoTaskMemFree frei werden, wenn sie nicht mehr benötigt wird.

cchBufferMax [ In]

Typ: UINT

Die maximale Anzahl von Zeichen, die aus der Ressourcentabelle geladen werden. Wenn die Ressourcenzeichenfolge länger als die angegebene Anzahl von Zeichen ist, wird sie abgeschnitten und auf NULL beendet.

Hinweis

Dieser Parameter darf nicht auf 0 (null) festgelegt werden.

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. folgende:

Rückgabecode Beschreibung
S _ OK
Der Vorgang wurde erfolgreich ausgeführt.
E _ INVALIDARG
Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
[Windows 8 Nur Desktop-Apps]
Unterstützte Mindestversion (Server)
[Windows Server 2012 Nur Desktop-Apps]
Header
Ndattributils.h

Weitere Informationen

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree