IShellLinkW::GetArguments-Methode (shobjidl_core.h)

  • Artikel

Ruft die Befehlszeilenargumente ab, die einem Shell-Linkobjekt zugeordnet sind.

Syntax

HRESULT GetArguments(
  [out] LPWSTR pszArgs,
  [in]  int    cch
);

Parameter

[out] pszArgs

Typ: LPTSTR

Ein Zeiger auf den Puffer, der bei erfolgreicher Rückgabe dieser Methode die Befehlszeilenargumente empfängt.

[in] cch

Typ: int

Die maximale Anzahl von Zeichen, die in den vom pszArgs-Parameter bereitgestellten Puffer kopiert werden können. Im Fall einer Unicode-Zeichenfolge gibt es keine Einschränkung für die maximale Zeichenfolgenlänge. Bei einer ANSI-Zeichenfolge variiert die maximale Länge der zurückgegebenen Zeichenfolge abhängig von der Version von Windows – MAX_PATH vor Windows 2000 und INFOTIPSIZE (definiert in Commctrl.h) in Windows 2000 und höher.

Rückgabewert

Typ: HRESULT

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

Hinweise

In Windows 7 und höher wird empfohlen, Argumentzeichenfolgen über IPropertyStore (unter Verwendung des PKEY_Link_Arguments-Werts) anstelle dieser Methode abzurufen, die die Zeichenfolge unbeaufsichtigt abschneiden kann, wenn der bereitgestellte Puffer nicht groß genug ist. IPropertyStore weist eine Zeichenfolge der richtigen Größe zu.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h
DLL Shell32.dll (Version 4.0 oder höher)

Weitere Informationen

IShellLink

IShellLink::SetArguments

IShellLinkA

IShellLinkW