SHGetUnreadMailCountW 함수(shellapi.h)

모든 전자 메일 계정에 대해 지정된 사용자의 읽지 않은 메시지 수를 검색합니다.

구문

HRESULT SHGetUnreadMailCountW(
  [in, optional]  HKEY     hKeyUser,
  [in, optional]  LPCWSTR  pszMailAddress,
  [out, optional] DWORD    *pdwCount,
  [out, optional] FILETIME *pFileTime,
  [out, optional] LPWSTR   pszShellExecuteCommand,
                  int      cchShellExecuteCommand
);

매개 변수

[in, optional] hKeyUser

형식: HKEY

지정된 사용자에 대한 유효한 HKEY입니다. 함수가 사용자 환경에서 호출되는 경우 이 매개 변수는 NULL 이어야 하며, 이 경우 HKEY_CURRENT_USER 사용됩니다. 함수가 SYSTEM 컨텍스트에서 호출되는 경우 이 매개 변수는 NULL 이어야 합니다. 이 경우 HKEY_USERS\{SID} 가 사용됩니다.

[in, optional] pszMailAddress

형식: LPCTSTR

지정한 사용자에 속한 계정의 이메일 주소를 지정하는 유니코드의 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 pdwCount 는 지정된 사용자가 소유한 모든 계정에 대해 읽지 않은 메시지의 총 수를 반환합니다.

[out, optional] pdwCount

형식: DWORD*

읽지 않은 메시지 수를 수신하는 DWORD 값에 대한 포인터입니다.

[out, optional] pFileTime

형식: FILETIME*

FILETIME 구조체에 대한 포인터입니다. 이 매개 변수의 사용은 pszMailAddress 가 NULL인지 여부에 따라 결정됩니다. pszMailAddress가 NULL인 경우 이 매개 변수는 필터를 지정하는 [in] 매개 변수로 처리되므로 지정된 시간보다 읽지 않은 메일만 표시됩니다. pszMailAddress가 NULL이 아닌 경우 이 매개 변수는 [out] 매개 변수로 처리됩니다. 이 매개 변수는 함수가 지정된 사용자 및 전자 메일 계정에 대한 마지막 SHSetUnreadMailCount 호출의 타임스탬프를 배치하는 FILETIME 구조를 가리킵니다.

[out, optional] pszShellExecuteCommand

형식: LPCTSTR

지정된 사용자 및 전자 메일 계정에 대한 마지막 SHSetUnreadMailCount 호출에 전달된 ShellExecute 명령문을 반환하는 문자열에 대한 포인터입니다. 이 명령 문자열은 pszMailAddress에서 참조하는 계정을 소유하는 이메일 애플리케이션을 시작합니다. ShellExecute 명령이 필요하지 않은 경우 이 매개 변수는 NULL일 수 있습니다. pszMailAddress가 NULL인 경우 이 매개 변수는 무시되며 NULL이어야 합니다.

cchShellExecuteCommand

형식: int

pszShellExecuteCommand가 가리키는 ShellExecute 명령 버퍼의 최대 크기(문자)입니다. pszMailAddress가 NULL인 경우 이 매개 변수는 총 개수에 대해 0이어야 합니다. ShellExecute 명령 문자열이 필요하지 않을 때마다 NULL 일 수도 있습니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)