SHGetDocumentsFolder

9/9/2008

Essa função recupera o caminho para o Diretório documentos para o volume especificado na pszVolume parâmetro.

Syntax

BOOL SHGetDocumentsFolder(
  LPCTSTR pszVolume,
  LPTSTR pszDocs
);

Parameters

• pszVolume
  [no] Ponteiro para uma seqüência de caracteres que contém o volume armazenamento da qual o caminho para o Diretório documentos deve ser recuperado.

• pszDocs
  [out] Ponteiro para uma seqüência de caracteres que contém o caminho Diretório documentos. Esta seqüência de caracteres devem ser alocado para um caminho at least como longo como o valor de MAX_PATH.

Return Value

Retorna TRUE se o caminho Diretório documentos foi copiado com êxito para pszDocs.

Retorna FALSE se um caminho Diretório documentos não existe para o volume especificado. De exemplo, essa função retornará FALSE se um volume armazenamento inicialmente for especificado, mas não há nenhum cartão armazenamento inserida no momento.

Requirements

Header	commctrl.h, shlobj.h
Library	ceshell.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later