共用方式為

GetRoleTextA 函式 （oleacc.h）

  • 發行項

擷取本地化字串，描述指定之角色值的物件角色。

語法

UINT GetRoleTextA(
  [in]  DWORD lRole,
  [out] LPSTR lpszRole,
  [in]  UINT  cchRoleMax
);

參數

[in] lRole

類型：DWORD

其中一個 物件角色 常數。

[out] lpszRole

類型：LPTSTR

接收角色文字字串之緩衝區的位址。 如果此參數 NULL，則函式會傳回角色字串的長度，不包括 null 字元。

[in] cchRoleMax

類型：UINT

lpszRole 參數所指向的緩衝區大小。 若為 ANSI 字串，此值是以位元組為單位來測量;若為 Unicode 字串，則會以字元為單位來測量。

傳回值

類型：UINT

如果成功，而且如果 lpszRole 為非NULL，則傳回值會是複製到緩衝區的位元組數（ANSI 字元串）或字元（Unicode 字元串），不包括終止的 Null 字元。 如果 lpszRoleNULL，則傳回值代表字串的長度，不包含 null 字元。

如果字串資源不存在，或者如果 lpszRole 參數不是有效的指標，則傳回值為零 （0）。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

注意

oleacc.h 標頭會將 GetRoleText 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 oleacc.h
連結庫 Oleacc.lib
DLL Oleacc.dll
可轉散發 Windows NT 4.0 和更新版本和 Windows 95 上的 Active Accessibility 1.3 RDK