IShellLinkA::GetArguments-Methode (shobjidl_core.h)

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

Syntax

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

Parameter

[out] pszArgs

Typ: LPTSTR

Ein Zeiger auf den Puffer, der die Befehlszeilenargumente empfängt, wenn diese Methode erfolgreich zurückgegeben wird.

[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. Im Fall einer ANSI-Zeichenfolge variiert die maximale Länge der zurückgegebenen Zeichenfolge je nach 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 automatisch abschneiden kann, wenn der bereitgestellte Puffer nicht groß genug ist. IPropertyStore weist eine Zeichenfolge der richtigen Größe zu.

Anforderungen

Anforderung Wert
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