共用方式為

resapi.h) PRESOURCE_CONTROL_ROUTINE 回呼函式 (

  • 發行項

執行套用至 資源的作業。 PRESOURCE_CONTROL_ROUTINE類型會定義此函式的指標。

語法

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

參數

[in] Resource

受影響資源的資源標識碼。

[in] ControlCode

控制項程式代碼 ，表示要執行的作業。 如需 ControlCode 參數的有效值清單，請參閱 資源類型控制代碼。

[in, optional] InBuffer

緩衝區的指標，其中包含要用於作業的數據。 如果不需要任何數據，InBuffer 可以是 NULL。

[in] InBufferSize

InBuffer 所指向之緩衝區的大小，以位元組為單位。

[out, optional] OutBuffer

緩衝區的指標，其中包含作業所產生的數據。 如果作業不需要傳回數據，OutBuffer 可以是 NULL。

[in] OutBufferSize

OutBuffer 所指向可用空間的大小，以位元組為單位。

[out] BytesReturned

作業所產生的數據的實際大小，以位元組為單位。

傳回值

傳回碼/值 Description
ERROR_SUCCESS
0
 與 ControlCode 相關聯的作業已順利完成。
ERROR_INVALID_FUNCTION
1
 資源 DLL 要求 資源監視器 執行預設處理 (如果任何 controlCode 的) ，以及 DLL 所提供的處理 (如果有任何) 。
ERROR_MORE_DATA
234 (0xEA)
OutBuffer 的配置大小太小，無法保存要求的數據。 BytesReturned 表示所需的大小。 計算字串的位元組大小時，一律包含終止 NULL 。
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
表示已在叢集資料庫中設定資源的新屬性值，但屬性尚未生效。 在資源脫機並上線之後，將會套用新的屬性值。
錯誤碼
 作業失敗。

備註

某些控制項程式代碼應該由資源 DLL 處理，而其他控件程式代碼則應該保留給資源監視器。 如需 ResourceControl 進入點函式的有效實作策略，請參閱 實作 ResourceControl。

範例

請參閱 資源 DLL 範例。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台 Windows
標頭 resapi.h

另請參閱

資源 DLL Entry-Point 函式