Partilhar via


AfxBeginThread

Chamar essa função para criar um novo segmento.

CWinThread* AfxBeginThread(  AFX_THREADPROC pfnThreadProc,  LPVOID pParam,  int nPriority = THREAD_PRIORITY_NORMAL,  UINT nStackSize = 0,  DWORD dwCreateFlags = 0,  LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL ); CWinThread* AfxBeginThread(  CRuntimeClass* pThreadClass,  int nPriority = THREAD_PRIORITY_NORMAL,  UINT nStackSize = 0,  DWORD dwCreateFlags = 0,  LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL );

Parâmetros

  • pfnThreadProc
    Pontos à função de controle para a thread de trabalho.Não pode ser NULO.Essa função deve ser declarada como segue:

    UINT __cdecl MyControllingFunction( LPVOID pParam );

  • pThreadClass
    RUNTIME_CLASS de um objeto derivado de CWinThread.

  • pParam
    Parâmetro a ser passado para a função de controle conforme mostrado no parâmetro a declaração da função em pfnThreadProc.

  • nPriority
    A prioridade desejada do segmento.Para obter uma lista completa e uma descrição de prioridades disponíveis, consulte SetThreadPriority em Windows SDK.

  • nStackSize
    Especifica o tamanho em bytes de pilha para o novo segmento.Se 0, as opções de tamanho de pilha para a pilha do mesmo tamanho que o segmento criador.

  • dwCreateFlags
    Especifica um parâmetro adicional que controla a criação de segmento.Este sinalizador pode conter um dos dois valores:

    • CREATE_SUSPENDED o segmento Comece com uma contagem de suspensão de uma.Use CREATE_SUSPENDED se você deseja inicializar quaisquer dados de membros do objeto de CWinThread , como m_bAutoDelete ou quaisquer membros de sua classe derivada, antes que o segmento iniciar a execução.Após a inicialização estiver concluída, use CWinThread::ResumeThread para iniciar a execução de segmento.O segmento não será executado até que CWinThread::ResumeThread seja chamado.

    • 0 Início o segmento imediatamente após a criação.

  • lpSecurityAttrs
    Pontos a estrutura de SECURITY_ATTRIBUTES que especifica atributos de segurança para o segmento.Se NULO, os mesmos atributos de segurança que o segmento criador será usado.Para obter mais informações sobre essa estrutura, consulte Windows SDK.

Valor de retorno

Ponteiro para o objeto criado de segmento, ou NULO se uma falha ocorre.

Comentários

O primeiro formulário de AfxBeginThread cria um segmento de trabalho.O segundo formulário cria um segmento que pode servir como um encadeamento de interface do usuário ou como um segmento de trabalho.

AfxBeginThread cria um novo objeto de CWinThread , chama a função de CreateThread para iniciar executar o segmento, e retorna um ponteiro para o segmento.Verifica são feitas durante qualquer procedimento para certificar-se que todos os objetos são desalocados corretamente se qualquer parte da falha de design.Para encerrar o segmento, chame AfxEndThread de dentro do segmento, ou retorno de função de controle da thread de trabalho.

Multithreading deve ser habilitada pelo aplicativo; caso contrário, essa função falhará.Para obter mais informações sobre como habilitar multithreading, consulte / MD, /MT, /LD (biblioteca de tempo de execução de uso) em Opções do compilador do Visual C++.

Para obter mais informações sobre AfxBeginThread, consulte os artigos Multithreading: Criando segmentos de trabalho e Multithreading: Criando segmentos da interface do usuário.

Exemplo

Consulte o exemplo para CSocket::Attach.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

AfxGetThread

Conceitos

Globais e Macros do MFC