InitVariantFromStrRet-Funktion (propvarutil.h)
Initialisiert eine VARIANT-Struktur mit einer Zeichenfolge, die in einer STRRET-Struktur gespeichert ist.
Syntax
PSSTDAPI InitVariantFromStrRet(
[in] STRRET *pstrret,
[in] PCUITEMID_CHILD pidl,
[out] VARIANT *pvar
);
Parameter
[in] pstrret
Typ: STRRET*
Zeiger auf eine STRRET-Struktur .
[in] pidl
Typ: PCUITEMID_CHILD
PIDL des Elements, dessen Details abgerufen werden.
[out] pvar
Typ: VARIANT*
Wenn diese Funktion zurückgibt, enthält die initialisierte VARIANT-Struktur .
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Erstellt eine VT_BSTR Variante.
Hinweis Diese Funktion gibt die Ressourcen frei, die für den STRRET-Inhalt verwendet werden.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitVariantFromStrRet veranschaulicht.
// STRRET strret;
// PCUITEMID_CHILD pidl;
// Assume variables strret and pidl are initialized and valid.
VARIANT var;
HRESULT hr = InitVariantFromStrRet(strret, pidl, &var);
if (SUCCEEDED(hr))
{
// var now is valid and has type VT_BSTR.
VariantClear(&var);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propvarutil.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |