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 |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
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 |
|