_CrtSetDumpClient

安裝應用程式定義的函式以傾印 _CLIENT_BLOCK 類型記憶體區塊 (僅限偵錯版本)。

語法

_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );

參數

dumpClient
要攔截的新用戶端定義記憶體傾印函式。

傳回值

傳回先前定義的用戶端區塊傾印函式。

備註

函 _CrtSetDumpClient 式可讓應用程式連結自己的函式，以傾印儲存在記憶體區塊中的 _CLIENT_BLOCK 物件。 因此，每次偵錯傾印函式，例如 _CrtMemDumpAllObjectsSince 或 _CrtDumpMemoryLeaks 傾印 _CLIENT_BLOCK 記憶體區塊時，也會呼叫應用程式的傾印函式。 _CrtSetDumpClient 提供應用程式一個簡單的方法，來偵測記憶體流失，以及驗證或報告儲存在 _CLIENT_BLOCK 區塊中的資料內容。 未定義 時 _DEBUG ，會在前置處理期間移除 對 的 _CrtSetDumpClient 呼叫。

_CrtSetDumpClient 函式會安裝 dumpClient 中指定的新應用程式定義傾印函式，並傳回先前定義的傾印函式。 用戶端區塊傾印函式的範例如下所示：

void DumpClientFunction( void *userPortion, size_t blockSize );

userPortion 引數是記憶體區塊之使用者資料部分開頭的指標，而 blockSize 指定配置的記憶體區塊大小 (以位元組為單位)。 用戶端區塊傾印函式必須傳回 void。 傳入 _CrtSetDumpClient 的用戶端傾印函式指標是定義在 Crtdbg.h 中的 _CRT_DUMP_CLIENT 類型：

typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );

如需在類型記憶體區塊上運作之 _CLIENT_BLOCK 函式的詳細資訊，請參閱 用戶端區塊攔截函式 。 函 _CrtReportBlockType 式可用來傳回區塊類型和子類型的相關資訊。

需求

常式	必要的標頭
_CrtSetDumpClient	<crtdbg.h>

如需相容性詳細資訊，請參閱相容性。

程式庫

僅限偵錯版本的 C 執行階段程式庫。

另請參閱

偵錯常式
_CrtReportBlockType
_CrtGetDumpClient