_CrtSetDumpClient

Tür bellek bloklarının dökümünü _CLIENT_BLOCK almak için uygulama tanımlı bir işlev yükler (yalnızca hata ayıklama sürümü).

Sözdizimi

_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );

Parametreler

dumpClient
Bağlanacak yeni istemci tanımlı bellek dökümü işlevi.

Dönüş değeri

Önceden tanımlanmış istemci blok dökümü işlevini döndürür.

Açıklamalar

işlevi, _CrtSetDumpClient uygulamanın bellek bloklarında _CLIENT_BLOCK depolanan nesnelerin dökümünü almak için kendi işlevini bağlamasına olanak tanır. Sonuç olarak, bir bellek bloğu gibi veya _CrtDumpMemoryLeaks dökümü gibi _CrtMemDumpAllObjectsSince bir _CLIENT_BLOCK hata ayıklama dökümü işlevi her seferinde uygulamanın döküm işlevi de çağrılır. _CrtSetDumpClient bir uygulamaya bellek sızıntılarını algılamak ve bloklarda _CLIENT_BLOCK depolanan verilerin içeriğini doğrulamak veya raporlamak için kolay bir yöntem sağlar. Tanımlanmadığında _DEBUG , çağrısı _CrtSetDumpClient ön işleme sırasında kaldırılır.

işlevi, _CrtSetDumpClient içinde dumpClient belirtilen yeni uygulama tanımlı döküm işlevini yükler ve önceden tanımlanmış döküm işlevini döndürür. İstemci blok dökümü işlevine örnek olarak şunlar verilmiştir:

void DumpClientFunction( void *userPortion, size_t blockSize );

userPortion bağımsız değişkeni, bellek bloğunun kullanıcı verileri bölümünün başlangıcına yönelik bir işaretçidir ve blockSize ayrılan bellek bloğunun boyutunu bayt cinsinden belirtir. İstemci blok dökümü işlevi döndürmelidir void. geçirilen _CrtSetDumpClient istemci dökümü işlevinin işaretçisi, Crtdbg.h'de tanımlandığı gibi türündedir _CRT_DUMP_CLIENT:

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

Tür bellek blokları üzerinde _CLIENT_BLOCK çalışan işlevler hakkında daha fazla bilgi için bkz . İstemci bloğu kanca işlevleri. İşlev, _CrtReportBlockType blok türleri ve alt türleri hakkında bilgi döndürmek için kullanılabilir.

Gereksinimler

Yordam	Gerekli başlık
_CrtSetDumpClient	<Crtdbg>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Kitaplıklar

Yalnızca C çalışma zamanı kitaplıklarının sürümlerinde hata ayıklama.

Ayrıca bkz.

Hata ayıklama yordamları
_CrtReportBlockType
_CrtGetDumpClient