取得要明確包含在範圍中的檔案名稱集合。
HRESULT GetFilenameIncludes(
LPWSTR pszFilenameIncludes,
ULONG *pcchLength);
參數
- pszFilenameIncludes
[in, out, unique, size_is(*pcchLength)] 傳回明確包括在此範圍內的檔案名稱清單，以分號分隔。此清單中未包括的檔案會從範圍中排除。如果這項值是空字串 " "，就不會明確包括任何檔案。預設值為 "*.*"。
- pcchLength
[in, out] 指定 pszFilenameIncludes 中的字元數目。如果 pszFilenameIncludes 太小，就傳回擷取此清單所需的字元數目，或傳回寫入的字元數目。
傳回值
S_OK。
當 pszFilenameIncludes 太小時，為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的字元數目是在 pcchLength 中傳回。
E_OUTOFMEMORY。
備註
萬用字元 (* 和 ?)可用於檔案名稱。
明確併入的作用比排除更弱。因此，如果某個檔案或資料夾由某個其他篩選所排除，將會從範圍中排除該檔案或資料夾，即使它已明確包含在這個清單中亦然。
注意
pszFilenameIncludes 中未包括的檔案會從範圍中排除。例如，假設 pszFilenameIncludes 是設定為空字串 " "，則所有檔案都會從範圍中排除。