Función InitPropVariantFromStrRet (propvarutil.h)
Inicializa una estructura PROPVARIANT basada en una cadena almacenada en una estructura STRRET .
Sintaxis
PSSTDAPI InitPropVariantFromStrRet(
[in, out] STRRET *pstrret,
[in] PCUITEMID_CHILD pidl,
[out] PROPVARIANT *ppropvar
);
Parámetros
[in, out] pstrret
Tipo: STRRET*
Puntero a una estructura STRRET que contiene la cadena.
[in] pidl
Tipo: PCUITEMID_CHILD
PIDL del elemento cuyos detalles se están recuperando.
[out] ppropvar
Tipo: PROPVARIANT*
Cuando se devuelve esta función, contiene la estructura PROPVARIANT inicializada.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Crea un VT_LPWSTR propvariante.
Nota Esta función libera la memoria usada para el contenido de STRRET .
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar InitPropVariantFromStrRet.
// STRRET strret;
// PCUITEMID_CHILD pidl;
// Assume variables strret and pidl are initialized and valid.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStrRet(strret, pidl, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
PropVariantClear(&propvar);
// Any allocated memory associated with strret has been freed.
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Windows Desktop Search (WDS) 3.0 |