WD_License

#define WD_License	(		h,
			pLicense
	)		WD_FUNCTION(IOCTL_WD_LICENSE, h, pLicense, sizeof(WD_LICENSE), FALSE)

Transfers the license string to the WinDriver kernel module When using the high-level WDC library APIs, described in the WinDriver PCI Manual, the license registration is done via the WDC_DriverOpen() function, so you do not need to call WD_License() directly.

Parameters

[in]	h	Handle to WinDriver's kernel-mode driver as received from WD_Open()
[in]	pLicense	Pointer to a WinDriver license information structure

Returns

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise: WD_MORE_PROCESSING_REQUIRED will be returned when this license requires further online validation using the WinDriver Agent. See WD_AgentStart() for more info.

Remarks

When using any registered version, this function must be called before any other WinDriver API call, apart from WD_Open(), in order to register the license from the code.

/* Use the returned handle when calling WinDriver API functions */
HANDLE WinDriverOpenAndRegister(void)
{
    HANDLE hWD;
    WD_LICENSE lic;
    DWORD dwStatus;
 
    hWD = WD_Open();
    if (hWD != INVALID_HANDLE_VALUE)
    {
        BZERO(lic);
 
        /* Replace the following string with your license string: */
        strcpy(lic.cLicense, "12345abcde12345.CompanyName");
        dwStatus = WD_License(hWD, &lic);
        if (WD_MORE_PROCESSING_REQUIRED == dwStatus)
        {
            dwStatus = WD_AgentStart(hWD, lic.cLicense, 0);
            if (WD_STATUS_SUCCESS != dwStatus)
            {
                WDC_Err("%s: Failed starting agent: %s\n", __FUNCTION__, 
                    Stat2Str(dwStatus));
                hWD = INVALID_HANDLE_VALUE;
            }
        }
        if (dwStatus != WD_STATUS_SUCCESS)
        {
            WD_AgentClose();
            WD_Close(hWD);
            hWD = INVALID_HANDLE_VALUE;
        }
    }
    return hWD;
}

Definition at line 2561 of file windrvr.h.