UtilLoadStringWithAlloc-Funktion

Artikel
06/13/2023

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 freigegeben werden, wenn sie nicht mehr benötigt wird.

cchBufferMax [in]

Typ: UINT

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

Hinweis

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

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_INVALIDARG	Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

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

Siehe auch

UtilStringCopyWithAlloc
UtilAssembleStringsWithAlloc
CoTaskMemFree

Freigeben über