You are here: NI Home > Support > Product Reference > Manuals > LabVIEW 8.5 Help

MgErr DSSetHandleFromPtrNULLMeansEmpty(void *ph, const void *psrc, size_t n);

Purpose

Copies the data referenced by the pointer psrc into the handle pointed to by ph. This function is similar to the DSSetHandleFromPtr function except that when the pointer psrc has no data, the DSSetHandleFromPtrNULLMeansEmpty function deallocates and NULLs the handle if zero bytes is requested.

Parameters

Name	Type	Description
ph	UHandle	Pointer to a handle that the data from psrc is copied into. The allocated handle can contain n bytes of data.
psrc	UHandle	Pointer to the data of interest.
n	size_t	Number of bytes of data in psrc.

Return Value

MgErr, which can contain the following errors. If you receive errors from CIN functions, most error names correspond to LabVIEW error codes.

Value	Corresponding Error Code or Description
noErr	No error.
mgArgErr	1
mFullErr	2