共用方式為

GetStateTextA 函式 （oleacc.h）

  • 發行項

擷取本地化字串，描述單一預先定義狀態位旗標的對象狀態。 由於狀態值是一個或多個位旗標的組合，用戶端會多次呼叫此函式以擷取所有狀態字串。

語法

UINT GetStateTextA(
  [in]  DWORD lStateBit,
  [out] LPSTR lpszState,
  [in]  UINT  cchState
);

參數

[in] lStateBit

類型：DWORD

其中一個 物件狀態常數。

[out] lpszState

類型：LPTSTR

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

[in] cchState

類型：UINT

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

傳回值

類型：UINT

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

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

言論

此函式一次只接受一個狀態位，而不是位掩碼。

注意

oleacc.h 標頭會將 GetStateText 定義為別名，根據 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