Funzione StrRetToBSTR (shlwapi.h)
Accetta una struttura STRRET restituita da IShellFolder::GetDisplayNameOf contenente o punta a una stringa e restituisce tale stringa come BSTR.
Sintassi
LWSTDAPI StrRetToBSTR(
[in, out] STRRET *pstr,
[in] PCUITEMID_CHILD pidl,
[out] BSTR *pbstr
);
Parametri
[in, out] pstr
Tipo: STRRET*
Puntatore a una struttura STRRET . Quando la funzione restituisce, questo puntatore è più valido.
[in] pidl
Tipo: PCUITEMID_CHILD
Puntatore a un elemento ITEMIDLIST che identifica in modo univoco un oggetto file o una sottocartella relativa alla cartella padre. Questo valore può essere NULL.
[out] pbstr
Tipo: BSTR*
Puntatore a una variabile di tipo BSTR che riceve la stringa convertita.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se il membro uType della struttura STRRET a cui fa riferimento pstr è impostato su STRRET_WSTR, il membro pOleStr di tale struttura viene liberato al ritorno.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shlwapi.h |
| Libreria | Shlwapi.lib |
| DLL | Shlwapi.dll (versione 5.5 o successiva) |