apc.c File Reference

#include "precomp.h"

Include dependency graph for apc.c:

Go to the source code of this file.

Macros
#define	APCH   (HANDLE)'SOR '

Functions
DWORD WINAPI	WahOpenApcHelper (OUT PHANDLE ApcHelperHandle)
DWORD WINAPI	WahCloseApcHelper (IN HANDLE ApcHelperHandle)
DWORD WINAPI	WahCloseThread (IN HANDLE ApcHelperHandle, IN LPWSATHREADID ThreadId)
INT WINAPI	WahQueueUserApc (IN HANDLE ApcHelperHandle, IN LPWSATHREADID ThreadId, IN LPWSAUSERAPC ApcRoutine, IN PVOID ApcContext OPTIONAL)
DWORD WINAPI	WahOpenCurrentThread (IN HANDLE ApcHelperHandle, OUT LPWSATHREADID ThreadId)

Macro Definition Documentation

APCH

#define APCH   (HANDLE)'SOR '

Definition at line 14 of file apc.c.

Function Documentation

WahCloseApcHelper()

DWORD WINAPI WahCloseApcHelper

(

IN HANDLE

ApcHelperHandle

)

Definition at line 42 of file apc.c.

{
    DWORD ErrorCode;

    /* Enter the prolog, make sure we're initialized */
    ErrorCode = WS2HELP_PROLOG();
    if (ErrorCode != ERROR_SUCCESS) return ErrorCode;

    /* Validate handle */
    if (ApcHelperHandle != APCH) return ERROR_INVALID_PARAMETER;

    /* return */
    return ERROR_SUCCESS;
}

Referenced by WsProcDelete().

WahCloseThread()

DWORD WINAPI WahCloseThread	(	IN HANDLE	ApcHelperHandle,
		IN LPWSATHREADID	ThreadId
	)

Definition at line 59 of file apc.c.

{
    DWORD ErrorCode;

    /* Enter the prolog, make sure we're initialized */
    ErrorCode = WS2HELP_PROLOG();
    if (ErrorCode != ERROR_SUCCESS) return ErrorCode;

    /* Validate handles */
    if ((ApcHelperHandle != APCH) || (!ThreadId) || (!ThreadId->ThreadHandle))
    {
        /* Invalid helper/thread handles */
        return ERROR_INVALID_PARAMETER;
    }

    /* Close the thread handle */
    if (CloseHandle(ThreadId->ThreadHandle))
    {
        /* Clear the structure */
        ThreadId->ThreadHandle = NULL;
        ThreadId->Reserved = 0;
        return NO_ERROR;
    }

    /* return */
    return GetLastError();
}

Referenced by WsThreadDelete().

WahOpenApcHelper()

DWORD WINAPI WahOpenApcHelper

(

OUT PHANDLE

ApcHelperHandle

)

Definition at line 20 of file apc.c.

{
    DWORD ErrorCode;

    /* Enter the prolog, make sure we're initialized */
    ErrorCode = WS2HELP_PROLOG();
    if (ErrorCode != ERROR_SUCCESS) return ErrorCode;

    /* Validate handle */
    if (!ApcHelperHandle) return ERROR_INVALID_PARAMETER;

    /* 
     * Return a bogus handle ("ROS")
     * Historical note:(MS sends "CKM", which probably stands for "Keith Moore"
     * (KM), one of the core architects of Winsock 2.2 from Microsoft.
     */
    *ApcHelperHandle = APCH;
    return ERROR_SUCCESS;
}

Referenced by WsProcOpenAsyncHelperDevice().

WahOpenCurrentThread()

DWORD WINAPI WahOpenCurrentThread	(	IN HANDLE	ApcHelperHandle,
		OUT LPWSATHREADID	ThreadId
	)

Definition at line 118 of file apc.c.

{
    HANDLE ProcessHandle, ThreadHandle;

    /* Validate params  */
    if ((ApcHelperHandle != APCH) || (!ThreadId))
    {
        /* Invalid parameters */
        return ERROR_INVALID_PARAMETER;
    }

    /* Get the process/thread handles */
    ProcessHandle = GetCurrentProcess();
    ThreadHandle = GetCurrentThread();

    /* Duplicate the handle */
    if (DuplicateHandle(ProcessHandle,
                        ThreadHandle,
                        ProcessHandle,
                        &ThreadId->ThreadHandle,
                        0,
                        FALSE,
                        DUPLICATE_SAME_ACCESS))
    {
        /* Save the thread handle and return */
        ThreadId->Reserved = (DWORD_PTR)ThreadHandle;
        return ERROR_SUCCESS;
    }

    /* Fail */
    return GetLastError();
}

Referenced by WsThreadInitialize().

WahQueueUserApc()

INT WINAPI WahQueueUserApc	(	IN HANDLE	ApcHelperHandle,
		IN LPWSATHREADID	ThreadId,
		IN LPWSAUSERAPC	ApcRoutine,
		IN PVOID ApcContext	OPTIONAL
	)

Definition at line 90 of file apc.c.

{
    /* Validate params  */
    if ((ApcHelperHandle != APCH) ||
        (!ThreadId) ||
        (!ThreadId->ThreadHandle) ||
        (!ApcRoutine))
    {
        /* Invalid parameters */
        return ERROR_INVALID_PARAMETER;
    }

    /* Queue the APC */
    if (QueueUserAPC(ApcRoutine, ThreadId->ThreadHandle, (ULONG_PTR)ApcContext))
    {
        /* Return success */
        return ERROR_SUCCESS;
    }

    /* Fail */
    return GetLastError();
}