IItemNameLimits::GetValidCharacters-Methode (shobjidl_core.h)

Artikel
08/26/2023

Lädt eine Zeichenfolge, die jedes der Zeichen enthält, die im Namespace, unter dem sie aufgerufen wird, gültig oder ungültig sind.

Syntax

HRESULT GetValidCharacters(
  [out] LPWSTR *ppwszValidChars,
  [out] LPWSTR *ppwszInvalidChars
);

Parameter

[out] ppwszValidChars

Typ: LPWSTR*

Ein Zeiger auf eine Zeichenfolge, die alle gültigen Zeichen im Namespace enthält. Wenn der Namespace ungültige Zeichen in ppwszInvalidChars bereitstellt, gibt dieser Wert NULL zurück. Weitere Informationen finden Sie unter Hinweise.

[out] ppwszInvalidChars

Typ: LPWSTR*

Ein Zeiger auf eine Zeichenfolge, die alle ungültigen Zeichen im Namespace enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Standarddateisystem gibt beispielsweise die Zeichenfolge "/:*?"<>|" zurück. in ppwszInvalidChars und NULL in ppwszValidChars.

Beide Parameter können nicht NULL-Werte zurückgeben, sodass ppwszValidCharsaufgrund des Werts ungleich NULL zugewiesen wird.

in ppwszInvalidChars. Es wird davon ausgegangen, dass, wenn ungültige Zeichen angegeben sind, alles andere gültig ist. Nur wenn ppwszInvalidCharsNULL ist, enthält ppwszValidChars eine Liste aller gültigen Zeichen.

Wenn die Methode einen Erfolgscode zurückgibt, muss die zugeordnete Zeichenfolge mit CoTaskMemFree freigegeben werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll

Share via