SHSetUnreadMailCountW 함수(shellapi.h)

레지스트리에 지정된 전자 메일 계정에 대한 현재 사용자의 읽지 않은 메시지 수를 저장합니다.

구문

HRESULT SHSetUnreadMailCountW(
  [in] LPCWSTR pszMailAddress,
       DWORD   dwCount,
  [in] LPCWSTR pszShellExecuteCommand
);

[in] pszMailAddress

형식: LPCTSTR

현재 사용자의 전체 전자 메일 주소를 포함하는 유니코드의 문자열에 대한 포인터입니다.

dwCount

형식:DWORD

읽지 않은 메시지 수입니다.

[in] pszShellExecuteCommand

형식: LPCTSTR

ShellExecute에 전달할 수 있는 명령의 전체 텍스트를 포함하는 유니코드의 문자열에 대한 포인터입니다. 이 명령은 pszMailAddress에서 참조하는 계정을 소유하는 이메일 애플리케이션을 시작해야 합니다.

형식: HRESULT

다음과 같은 가능한 값을 포함하는 HRESULT입니다.

반환 코드	Description
S_OK	호출이 성공적으로 완료되었습니다.
E_OUTOFMEMORY	사용할 수 있는 메모리가 부족합니다.
E_INVALIDARG	pszMailAddress 또는 pszShellExecuteCommand 매개 변수의 문자열 인수가 잘못되었습니다.

이 함수가 레지스트리를 업데이트하면 새 레지스트리 항목에 현재 시간과 날짜가 자동으로 스탬프됩니다.

동일한 전자 메일 이름을 지정하는 다른 ISV(독립 소프트웨어 공급업체)에서 이 함수를 호출하는 경우 마지막 호출만 저장됩니다. 즉, 이 함수에 대한 호출은 다른 ISV에서 호출을 수행하더라도 이전에 저장된 동일한 전자 메일 주소 값을 덮어씁니다.

읽지 않은 메시지 수는 사용자 계정의 기본 받은 편지함에 대해서만 설정하는 것이 좋습니다. 초안 또는 삭제된 항목과 같은 하위 폴더의 메일은 무시해야 합니다.

읽지 않은 메시지 수가 0으로 잘못 보고되므로 이메일 클라이언트는 애플리케이션이 종료될 때 읽지 않은 메시지 수를 0으로 설정하지 않는 것이 중요합니다.

이 함수는 HKEY_CURRENT_USER 사용하므로 사용자를 가장하는 시스템 프로세스에서 호출해서는 안 됩니다.