IACList::Expand method (shlobj_core.h)
Requests that the autocompletion client generate candidate strings associated with a specified item in its namespace.
Syntax
HRESULT Expand(
[in] PCWSTR pszExpand
);
Parameters
[in] pszExpand
Type: PCWSTR
A pointer to a null-terminated, Unicode string to be expanded by the autocomplete object.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The autocomplete object calls this method when a delimiter is entered in the edit control. If the string pointed to by pszExpand matches an item in the autocompletion client's namespace, the client generates strings for those items that fall immediately under pszExpand in its namespace hierarchy. The client returns those strings next time the autocompletion object calls the client's IEnumString interface.
For example, assuming that the client's namespace consists of all the files and folders on the C: drive, and pszExpand is set to "C:\Program Files", the client should generate a list of strings corresponding to the fully qualified paths of the files and subfolders of "C:\Program Files".
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | shlobj_core.h |
| DLL | Shell32.dll (version 5.0 or later) |